home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 16 / CU Amiga Magazine's Super CD-ROM 16 (1997-10-16)(EMAP Images)(GB)[!][issue 1997-11].iso / CUCD / Graphics / Ghostscript / source / gxbitmap.h < prev    next >
C/C++ Source or Header  |  1997-07-16  |  6KB  |  136 lines
  1. /* Copyright (C) 1989, 1993, 1996, 1997 Aladdin Enterprises.  All rights reserved.
  2.   
  3.   This file is part of Aladdin Ghostscript.
  4.   
  5.   Aladdin Ghostscript is distributed with NO WARRANTY OF ANY KIND.  No author
  6.   or distributor accepts any responsibility for the consequences of using it,
  7.   or for whether it serves any particular purpose or works at all, unless he
  8.   or she says so in writing.  Refer to the Aladdin Ghostscript Free Public
  9.   License (the "License") for full details.
  10.   
  11.   Every copy of Aladdin Ghostscript must include a copy of the License,
  12.   normally in a plain ASCII text file named PUBLIC.  The License grants you
  13.   the right to copy, modify and redistribute Aladdin Ghostscript, but only
  14.   under certain conditions described in the License.  Among other things, the
  15.   License requires that the copyright notice and this notice be preserved on
  16.   all copies.
  17. */
  18.  
  19. /* gxbitmap.h */
  20. /* Definitions for stored bitmaps for Ghostscript */
  21.  
  22. #ifndef gxbitmap_INCLUDED
  23. #  define gxbitmap_INCLUDED
  24.  
  25. #include "gstypes.h"        /* for gs_id */
  26.  
  27. /*
  28.  * Drivers such as the X driver and the command list (band list) driver
  29.  * benefit greatly by being able to cache bitmaps (tiles and characters)
  30.  * and refer to them later.  To help them recognize when a bitmap is the
  31.  * same as one that they have seen before, the core code passes an optional
  32.  * ID with the property that if two bitmaps have the same ID, they are
  33.  * guaranteed to have the same contents.  (The converse is *not* true,
  34.  * however: two bitmaps may have different IDs and still be the same.)
  35.  */
  36. typedef gs_id gx_bitmap_id;
  37. #define gx_no_bitmap_id gs_no_id
  38.  
  39. /*
  40.  * Bitmaps are stored bit-big-endian (i.e., the 0x80 bit of the first
  41.  * byte corresponds to x=0), as a sequence of bytes (i.e., you can't
  42.  * do word-oriented operations on them if you're on a little-endian
  43.  * platform like the Intel 80x86 or VAX).  Each scan line must start on
  44.  * a `word' (long) boundary, and hence is padded to a word boundary,
  45.  * although this should rarely be of concern, since the raster and width
  46.  * are specified individually.  The first scan line corresponds to y=0
  47.  * in whatever coordinate system is relevant.
  48.  */
  49. /* We assume arch_align_long_mod is 1-4 or 8. */
  50. #if arch_align_long_mod <= 4
  51. #  define log2_align_bitmap_mod 2
  52. #else
  53. #if arch_align_long_mod == 8
  54. #  define log2_align_bitmap_mod 3
  55. #endif
  56. #endif
  57. #define align_bitmap_mod (1 << log2_align_bitmap_mod)
  58. #define bitmap_raster(width_bits)\
  59.   ((uint)(((width_bits + (align_bitmap_mod * 8 - 1))\
  60.     >> (log2_align_bitmap_mod + 3)) << log2_align_bitmap_mod))
  61. /*
  62.  * The basic structure for a bitmap does not specify the depth;
  63.  * this is implicit in the context of use.  Requirements:
  64.  *    size.x > 0, size.y > 0
  65.  *    raster >= (size.x * depth + 7) / 8
  66.  */
  67. #define gx_bitmap_common\
  68.     byte *data;\
  69.     int raster;            /* bytes per scan line */\
  70.     gs_int_point size;        /* width, height */\
  71.     gx_bitmap_id id
  72. typedef struct gx_bitmap_s {
  73.     gx_bitmap_common;
  74. } gx_bitmap;
  75. /*
  76.  * For bitmaps used as halftone tiles, we may replicate the tile in
  77.  * X and/or Y, but it is still valuable to know the true tile dimensions
  78.  * (i.e., the dimensions prior to replication).  Requirements:
  79.  *    width % rep_width = 0
  80.  *    height % rep_height = 0
  81.  * Note that height and rep_height mean something slightly different if
  82.  * shift != 0: see below.
  83.  */
  84. #define gx_tile_bitmap_common\
  85.     gx_bitmap_common;\
  86.     ushort rep_width, rep_height    /* true size of tile */
  87. typedef struct gx_tile_bitmap_s {
  88.     gx_tile_bitmap_common;
  89. } gx_tile_bitmap;
  90. /*
  91.  * For halftones at arbitrary angles, we provide for storing the halftone
  92.  * data as a strip that must be shifted in X for different values of Y.  For
  93.  * an ordinary (non-shifted) halftone that has a repetition width of W and a
  94.  * repetition height of H, the pixel at coordinate (X,Y) corresponds to
  95.  * halftone pixel (X mod W, Y mod H), ignoring phase; for a strip halftone
  96.  * with strip shift S and strip height H, the pixel at (X,Y) corresponds to
  97.  * halftone pixel ((X + S * floor(Y/H)) mod W, Y mod H).  In other words,
  98.  * each Y increment of H shifts the strip left by S pixels.
  99.  *
  100.  * As for non-shifted tiles, a strip bitmap may include multiple copies
  101.  * in X or Y to reduce loop overhead.  In this case, we must distinguish:
  102.  *    - The height of an individual strip, which is the same as
  103.  *    the height of the bitmap being replicated (rep_height, H);
  104.  *    - The height of the entire bitmap (size.y).
  105.  * Similarly, we must distinguish:
  106.  *    - The shift per strip (rep_shift, S);
  107.  *    - The shift for the entire bitmap (shift).
  108.  * Note that shift = (rep_shift * size.y / rep_height) mod rep_width,
  109.  * so the shift member of the structure is only an accelerator.  It is,
  110.  * however, an important one, since it indicates whether the overall
  111.  * bitmap requires shifting or not.
  112.  *
  113.  * Note that for shifted tiles, size.y is the size of the stored bitmap
  114.  * (1 or more strips), and NOT the height of the actual tile.  The latter
  115.  * is not stored in the structure at all: it can be computed as H * W /
  116.  * gcd(S, W).
  117.  *
  118.  * If the bitmap consists of a multiple of W / gcd(S, W) copies in Y, the
  119.  * effective shift is zero, reducing it to a tile.  For simplicity, we
  120.  * require that if shift is non-zero, the bitmap height be less than H * W /
  121.  * gcd(S, W).  I.e., we don't allow strip bitmaps that are large enough to
  122.  * include a complete tile but that don't include an integral number of
  123.  * tiles.  Requirements:
  124.  *    rep_shift < rep_width
  125.  *    shift = (rep_shift * (size.y / rep_height)) % rep_width
  126.  */
  127. #define gx_strip_bitmap_common\
  128.     gx_tile_bitmap_common;\
  129.     ushort rep_shift;\
  130.     ushort shift
  131. typedef struct gx_strip_bitmap_s {
  132.     gx_strip_bitmap_common;
  133. } gx_strip_bitmap;
  134.  
  135. #endif                    /* gxbitmap_INCLUDED */
  136.